﻿
                
  
                                 FUEL RELOADED

                                    By WTLS




ABOUT THIS TXT:

This txt content:
- Description,
- Requirements,
- Known issues and their solutions,
- Installation,
- Optional installation,
- How to use,
- Changelog,
- Credits,
- Notes.





DESCRIPTION:

This is a simple fuel mod that has a lot of features, 4 consumption types, 
8 vehicle types.

Features:
- Fuel in all vehicle types (also planes, helis and boats),
- Electric cars has chargeable battery,
- Plug-in Hybrid cars,
- Methanol cars,
- Throttle/RPM based consumption (more throttle pressing, more consumption),
- Fuel price differs form a vehicle type to another,
- Refueling in gas stations,
- Fuel station colored blips are visible on the map only when the player is 
  in vehicle,
- Player can't refuel if he has not enough money (can be disabled),
- Horn/context to refuel,
- Rehorn/repressing context to stop refueling (if you want only a specefic amount
  of fuel),
- Refuel with jerrycan of realistic volume,
- Jerrycan refueling animation,
- Jerrycan controller support,
- Engine stops if you ran out of fuel,
- Small fuel level indicator,
- Distance left display,
- Fuel level linked also to fuel gauge on the dashboard,
- Fuel linked with tank and decreases if there is a leak,
- Fuel level indicator turns red if the fuel level is low,
- A lot of options in customization ini file,
- Saves fuel level of the last 20 driven vehicles,
- Saves fuel level of the last 5 driven vehicles with their license plates.

In GTA we always notice that electric cars have very higher acceleration than 
other cars, so why don't we drive only this type of cars that don't need to be 
charged, you know that the only bad thing in e-cars is that you have to wait 
hours to get the batterie charged, so this mod adds this missing thing to the 
game to make e-cars equal with other cars.

Features of electric cars:
- Realistic e-car consumption,
- Regenerative Braking System (an electrical braking that takes kenetic energy 
  and bring it back to the batterie),
- Fast charge at charging stations,
- You can leave your e-car while recharging and come back when it is charged,
- Blue battery level indicator,
- Custom addon ecars (taranis and savanna already added in the script),
- You can charge multiple e-cars at the same time (max 20 driven vehicles),
- Station blips are showen if the player is in e-car,
- Charging in stations (fast) and at home (normal),
- Free charging at home,
- Notification if Charging is complete,
- Recharge Skipping By Sleeping, you can sleep to skip a duration of recharging 
  (franklin, michael and trevor sleep 8, 6, 12 hours respectively).

R* didn't say that there is in GTA electric cars or a specific car is electric, 
there is some cars that are actually Hybrid. This mod adds all Plug-in Hybrid 
features with all its automatic modes to game.

Features of Hybrid cars:
- Two automatic modes (Charge Depleting Mode and Charge Sustaining Mode),
- Charge Sustaining Mode modes (Mild Acceleration, Full Acceleration and Power 
  Assest Mode),
- Regenerative Braking System,
- Two gauges display (fuel and batterie) or one green energy level gauge,
- Plug-in feature (the car can be charged in charging stations and at home),
- Notification if Charging is complete,
- Recharge Skipping By Sleeping.

Methanol car is a hydrogen-electric hybrid sports car running on methanol to 
generate hydrogen that is scheduled to enter production in 2021, RG Nathalie is 
the first car produced by the new car manufacturer RG founded by Roland Gumpert.

Features of methanol cars:
- The batterie is always charging as long as methanol tank is not empty,
- Refuel Methanol at station (there is only one that has been opened for now in 
  Los Santos xD),
- Regenerative Braking System,
- Two gauges display (purple methanol and blue batterie gauge) or one purple 
  methanol gauge,
- Plug-in feature (you can charge the car at charging stations and at home),
- Notification if Charging is complete,
- Recharge Skipping By Sleeping.


Customization:
- Fuel bar position,
- Fuel bar size,
- One or two gauges,
- Throttle or RPM based,
- Horn or context to refuel,
- Custom refuel key,
- Fast refuel key,
- Requires money or not,
- Toggle blips,
- Link with tank or not,
- Disable spark effect at low fuel,
- Enable/disable fuel,
- Enable/disable ecars,
- Enable/disable planes/helis/boats,
- Enable/disable hybrid,
- Enable/disable methanol,
- Custom full tank/batterie price of each vehicle type,
- Custom range of each vehicle type,
- Custom refueling/recharging time of each vehicel type,
- 16 custom addon ecars, hybrid and methanol cars,
- 70 custom fuel/charge stations of all vehicle types,

E-cars:
- Pfister Neon,
- Coil Raiden,
- Pegassi Tezeract,
- Coil Voltic.
- Airtug,
- Caddy,
- Taranis (Addon),
- Savanna (Addon).
- Obey I-wagen
- Obey Omnis e-GT
- Ocelot Virtue
- Bravado Buffalo EVX
- Penaud La Coureuse

Hybrid cars:
- Karin Dilettante,
- Hijak Khamelion,
- Cheval Surge,
- Coil Cyclone.

Methanol cars:
- Overflod Imorgon.





REQUIREMENTS:

- ScriptHookV,
- ScriptHookVDotNet.





KNOWN ISSUES AND SOLUTIONS:

The blips stays in the map if you reload mods,
> Exit vehicle if you want to reload mods.

Can't refuel in gas stations
> if you are using LSPDFR, disable REQUIRESMONEY and enable CONTEXTTOREFUEL in the ini file.

Can't refuel with characters except the 3 main storymode characters,
> Disable REQUIRESMONEY in the ini file.

Helicopter refuel works only with horn to refuel option,
> Disable CONTEXTTOREFUEL in the ini file.

- Other?
> Report on #bugs-report channel on discord server. If it's a script error, include the text inside "ScriptHookVDotNet.txt" file in GTA5 main directory.






INSTALLATION:

Open "Install" folder from the downloaded archive,
Put "FuelReloaded3.dll", "FuelReloaded3.ini" and "FuelReloaded.xml" in "scripts" folder.
Put "FuelReloaded3" folder in "scripts" folder.






OPTIONAL INSTALLATION:

If you want realistic settings (the range and refueling time to real life vehicles) set this parameters in this values:

FOURWHEELSRANGE=1000
BIKERANGE=500
PLANERANGE=4500
HELIRANGE=2000
BOATRANGE=3600
ECARRANGE=500
HYBRIDRANGE=1050
METHANOLRANGE=820

FOURWHEELSREFUELINGTIME=300
BIKEREFUELINGTIME=150
PLANEREFUELINGTIME=1200
HELIREFUELINGTIME=500
BOATREFUELINGTIME=900
RECHARGINGTIME=21600
RECHARGINGFASTTIME=5400
METHANOLREFUELINGTIME=90







HOW TO USE:

Fuel level / battery level indicator is showen when you are in vehicle,
Distance left before you run out of fuel is showen,
Stations are showen on the map when you are in vehicle,
Go to a station and horn/context to refuel / recharge,
You can stop refueling / recharging by horning/pressing context again,
You can leave your recharging e-car,
You can recharge multiple e-cars (20 max driven vehicles, if you get in the 21th 
electric or not electric the first recharging e-car will stop recharging and its
battery will be random),
You can go to sleep while recharging e-cars to accelerate recharging,
To use Regenerative Braking System don't brake hard, brake less than 70%, when 
braking hard normal brakes are enggaged,
Pop up the phone to show Coil display on foot (the last driven car must be
a supported car).

Ini file:
GAUGEX and GAUGEY is position of the fuel bar,
GAUGEWIDTH and GAUGEHEIGHT is the size of fuel bar,
DISTANCELEFTX and DISTANCELEFTY is position of distance left before running out of
fuel,
DISTANCELEFTTEXTSIZE is the size of distance left,
ONEGAUGE if enabled one gauge instead of two gauges in hybrid and methanol cars 
is showen,
METRICUNITS set to true if you want metric units (kilometers), false if you want 
imperial units (miles),
THROTTLEBASED if enabled the consumption will be throttle based instead of RPM,
CONTEXTTOREFUEL context to refuel instead of horning,
ENABLECUSTOMREFUELKEY enable it if you want custom refuel key, disable it if 
you want to refuel by horning/pressing context,
CUSTOMREFUELKEY the key to refuel,
ENABLEFASTREFUELKEY enable it to refuel fast (max fuel, anywhere) when pressing 
the button,
FASTREFUELKEY the button to press to refuel fast,
REQUIRESMONEY enable if you want to pay, disable if you have trouble refueling 
with a character except micheal, trevor and franklin,
ENABLEREFUELWITHJERRYCAN enable to refuel with jerry can,
REFUELWITHJERRYCANKEY the key to hold to refuel with jerry can,
ENABLEBLIPSINTHESTART enable blips at the start,
ENABLETOGGLEBLIPSKEY enable ability to toggle blips by pressing a key,
TOGGLEBLIPSKEY the key to press to toggle blips,
LINKWITHTANK enable to make the fueljauge of the vehicle's dashboard working,
enable to link with the fuelgauge of lefix speedometer and with tank that when 
leaking the fuel decrease,
DISABLESPARKEFFECTATLOWFUEL disable the spark effect in the exhaust and small 
annoying rev at low fuel, but the dashboard fuel gauge (not the displayed)
minimum will be limited at 11%.
RANDOMFUELMIN min and max of random fuel of new vehcile that is now saved,
RANDOMFUELMAX
LOWFUELHINT low fuel notification,
ENABLEFUEL enable fuel in all fuel vehicles,
ENABLEPLANES enable planes,
ENABLEHELIS enable helicopters,
ENABLEBOATS enable boats,
ENABLEECARS enable ecars,
ENABLEHYBRIDCARS enable hybrid cars,
ENABLEMETHANOLCARS enable methanol cars,
FOURWHEELSFULLPRICE full tank/batterie price in GTA$,
BIKEFULLPRICE
PLANEFULLPRICE
HELIFULLPRICE
BOATFULLPRICE
ECARFULLPRICE
METHANOLFULLPRICE
FOURWHEELSRANGE the range in kilometers (he max distance reached with full 
tank/batterie), bigger value = energy last longer
BIKERANGE
PLANERANGE
HELIRANGE
BOATRANGE
ECARRANGE
HYBRIDRANGE
METHANOLRANGE 
FOURWHEELSREFUELINGTIME refueling/recharging time in minutes, 
smaller value = fast refueling/recharging
BIKEREFUELINGTIME
PLANEREFUELINGTIME
HELIREFUELINGTIME
BOATREFUELINGTIME
RECHARGINGTIME
RECHARGINGFASTTIME
METHANOLREFUELINGTIME
ADDONMODELECAR1 custom addon ecar model name, write "None" to disable,
ADDONMODELECAR2
ADDONMODELECAR3
ADDONMODELECAR4
ADDONMODELECAR5
ADDONMODELECAR6
ADDONMODELECAR7
ADDONMODELECAR8
ADDONMODELECAR9
ADDONMODELECAR10
ADDONMODELHYBRID1 custom addon hybrid model name, write "None" to disable,
ADDONMODELHYBRID2
ADDONMODELHYBRID3
ADDONMODELMETHANOL1 custom addon methanol model name, write "None" to disable,
ADDONMODELMETHANOL2
ADDONMODELMETHANOL3
STATION1X=0 the x of a custom fuel station, make it "0" to disable,
STATION1Y=0 the y of a custom fuel station,
STATION2X=0 
STATION2Y=0 
STATION3X=0 same,
STATION3Y=0
STATION4X=0 
STATION4Y=0 
STATION5X=0 same,
STATION5Y=0 
STATION6X=0 
STATION6Y=0 
STATION7X=0 
STATION7Y=0 same,
STATION8X=0 
STATION8Y=0 
STATION9X=0
STATION9Y=0 
STATION10X=0
STATION10Y=0 same,
STATIONPLANE, STATIONHELI... other custom stations of other vehicles.





CHANGELOG:

3.5.3:
- FormatException error hotfix.

3.5.2:
- Added option to turn off low fuel notification,
- Fixed NullReferenceException error after etering hybrid vehicle,
- Fixed some airplanes doesn't refuel,
- Fixed airplane engine doesn't start automatically after refueling,
- Fixed leaving e-cars charging not working (find it didn't recharge at all),
- Fixed bugs in the fuel tank after reloading scripts,
- Extended custom fuel stations to 30 slots,
- Extended custom fast charging stations to 25 slots,
- Some improvements.

3.5.1:
- Fixed NullReferenceException error.

3.4 and 3.4p:
- Added distance left display,
- Fixed ecar charging not working,
- Fixed jerrycan not working.

3.3.1:
- Fixed mod not working for Steam and Epic Games.

3.3:
- Added the new dlc cars,
- Extended custom addon ecars slots from 3 to 10,
- Fixed FPS drop,
- Added saving fuel level by license plate.

3.2:
- Added Jerry Can refueling animation,
- Added Jerry Can controller support,
- Added notification when e-car charging is complete.

3.1.2:
- Fixed helicopter refueling not working,
- Fixed low fuel in hybrid and methanol cars,
- Fixed colored methanol fuel blip,
- Other fixes.

3.1.1:
- Fixed low fuel hint (beta).

3.1 (alpha):
- Added low fuel/energy display,
- Added colorful blips.

3.0.1:
- Fixed option to add electric/hybrid/methanol addon cars not working,
- Fixed Jerry Can volume and refueling speed.  

3.0:
- Rewrote script,
- Added Plug-in Hybrid cars with all its modes,
- Added Methanol cars,
- Added e-car fast charging in stations,
- Added realistic e-car consumption,
- Added link with tank (the fuel decreases if there is leaking fuel),
- Added throttle based instead of RPM option,
- Added custom stations in all vehicle types,
- Added custom min and max of random fuel,
- Added custom refueling time,
- Added refuel by pressing context instead of horning option (of cource there is 
  custom refuel key),
- Added blip toggling by pressing a key,
- Added realistic jerry can fuel volume,
- Added hint to jerry can,
- Improved hint display,
- Improved settings (replaced price factor with full price and consumption factor
  with range),
- Fixed comma/dot problem (the vehicle run out of fuel once the player gets in 
  it),
- Fixed e-car charge skiping by sleeping not always works,
- Fixed only one e-car gets charged by sleeping,
- Fixed spark effect at low fuel,
- Fixed fuel and fuel display in vehicles not driven by player,
- Fixed one blip doesn't hide,
- Fixed no blips in Helicopters,
- Fixed value decimal in prices,
- Fixed jerry can not working,
- Fixed fuel gauge doesn't hide on disabled vehicles,
- Increased max number of vehicles to 20.

2.1:
- Fixed fuel/charge bar.

2.0:
- Rewrote script,
- Fixed skip ecar charging,
- Added refueling with jerrycan,
- Added ini file for customization,
- Added custom ecar models (taranis and savanna added in script),
- Added custom fuel stations for fuel land vehicles,
- Added fix for character can't refuel,
- Added fuelbar position and width and height customisable,
- Added custom refuel key,
- Added fast refuel key,
- Added enable/disable fourwheel vehicles/planes/helis/boats/ecars
- Added custom fuel/electricity price,
- Added custom consumption factor,
- Added custom charging time,
- Added enable/disable link with dashboard for the low fuel weird effect fix

1.0:
- first release.





CREDITS:

- Alexander Blade,
- Crosire,
- JAM102970 for testing the version 3.1.1.




NOTES!:

Support motivates us to update mods and make new ones.

Get Premium version from Patreon.

Do NOT redistribute or reupload or anything of stealing our work,

ENJOY!!!

                                        WTLS